<!DOCTYPE html>
<html lang="en">
<head>
<title>How do I configure the External Tool (LTI) settings?</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="" name="description">
<link href="../css/help.css" media="all" rel="stylesheet" type="text/css" charset="utf-8">
<link href="/library/webjars/fontawesome/4.7.0/css/font-awesome.min.css" media="screen" rel="stylesheet">
<link href="/library/skin/morpheus-default/tool.css" media="screen" rel="stylesheet" type="text/css" charset="utf-8">
<script src="/library/webjars/jquery/1.12.4/jquery.min.js" type="text/javascript" charset="utf-8"></script>
<script src="/library/js/headscripts.js" type="text/javascript" charset="utf-8"></script>
<script type="text/javascript" charset="utf-8">
    includeWebjarLibrary('featherlight');
    $(document).ready(function(){
      $("a.screensteps-image-zoom").featherlight({
        type: { image:true },
        closeOnClick: 'anywhere'
      }); 
    });   
</script>
</head>
<body>
  <div><div>
<div><h1 class="article-title">How do I configure the External Tool (LTI) settings?</h1></div>
<div>



    <div class="step-instructions screensteps-textblock screensteps-wrapper--introduction screensteps-wrapper">
  <div id="text-content_2199EC15-CE3E-4B9E-BDD8-D18FCC3F8F68" class="text-block-content">
    <p>If your External Tool has not already been configured by your system administrator, and you have the appropriate permissions to add or configure external tools, you may configure the tool in your site. Site members who are not site owners cannot access the configuration screen for the tool. Also, in some cases, institutions choose to limit external tool configuration permission to admins. </p>
  </div>
</div>

    <div class="step-instructions screensteps-textblock screensteps-wrapper--info screensteps-wrapper">
  <div id="text-content_F0852A12-DCCE-4A86-B2FB-69539E22CF5D" class="text-block-content">
    <p>The External Tool configuration within an individual course or project site (as opposed to the administrator-configured External Tools for the system within the Administration Workspace) should only be used to set up LTI 1.1 tools. LTI 1.3 / Advantage tools should be configured by your system administrator.</p>
  </div>
</div>

      <div class="step screensteps-section screensteps-depth-1" id="go-to-external-tool-lti">
    <h2 class="step-title screensteps-heading">Go to External Tool (LTI).</h2>
        <div class="image screensteps-image">
      <img src="https://media.screensteps.com/image_assets/assets/009/391/761/original/71163b3f-1a8d-4007-896d-91ccba5b0398.png" alt="" height="117" width="182">
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_CC5216D0-1799-45E1-95F1-907D5EBE30DF" class="text-block-content">
    <p>Select <strong>External Tool </strong>from the Tool Menu of your site. </p>
  </div>
</div>
 
  </div>

      <div class="step screensteps-section screensteps-depth-1" id="click-on-edit">
    <h2 class="step-title screensteps-heading">Click Edit.</h2>
        <div class="image screensteps-image">
      <a href="https://media.screensteps.com/image_assets/assets/009/391/763/original/2b683039-623e-4733-841d-45dcd9440a93.png" class="screensteps-image-zoom">
        <img src="https://media.screensteps.com/image_assets/assets/009/391/763/medium/2b683039-623e-4733-841d-45dcd9440a93.png" alt="" height="130" width="855">
      </a>
  </div>
 
  </div>

      <div class="step screensteps-section screensteps-depth-1" id="configure-the-external-tool-settings">
    <h2 class="step-title screensteps-heading">Configuring the External Tool settings</h2>
        <div class="image screensteps-image">
      <a href="https://media.screensteps.com/image_assets/assets/009/391/765/original/cbe58eed-2338-4a63-8936-cc0e853559c1.png" class="screensteps-image-zoom">
        <img src="https://media.screensteps.com/image_assets/assets/009/391/765/medium/cbe58eed-2338-4a63-8936-cc0e853559c1.png" alt="" height="251" width="855">
      </a>
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_FD8F65A2-EF40-4CC0-A828-FECD9071BA43" class="text-block-content">
    <p>The site owner can set up a link to any external tool by configuring the External Tool (LTI) manually. When you make arrangements with an external tool provider, they will provide you with a launch URL for the tool, key, and a secret. Enter these values as </p>
<ol>
<li>
<strong>Remote Tool Url</strong>, </li>
<li>
<strong>Remote Tool Key</strong>, and </li>
<li>
<strong>Remote Tool Secret</strong> respectively. </li>
</ol>
<p>Once you have entered these values into the tool, it can properly sign launch requests.</p>
  </div>
</div>
 
      <div class="step-instructions screensteps-textblock screensteps-wrapper--warning screensteps-wrapper">
  <div id="text-content_2F676597-8475-4948-B070-264852F1880C" class="text-block-content">
    <p><em><strong>Caution</strong>: Do not share these values with other members of the site. </em></p>
  </div>
</div>
 
        <div class="step screensteps-section screensteps-depth-2">
    <h3 class="step-title screensteps-heading">Configure the Display Information.</h3>
        <div class="image screensteps-image">
      <a href="https://media.screensteps.com/image_assets/assets/009/391/767/original/52ee851d-dee2-4e60-8e54-7389cf9ed521.png" class="screensteps-image-zoom">
        <img src="https://media.screensteps.com/image_assets/assets/009/391/767/medium/52ee851d-dee2-4e60-8e54-7389cf9ed521.png" alt="" height="154" width="855">
      </a>
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_E4D85D42-192A-4496-A0D0-832C0DCF538A" class="text-block-content">
    <ol>
<li>Complete the <strong>Set Tool Title</strong> field. </li>
<li>Optionally, click<strong> Choose an icon for this tool</strong> to select an custom icon for the external tool.</li>
</ol>
  </div>
</div>
 
  </div>
 
        <div class="step screensteps-section screensteps-depth-2" id="gradebook-settings">
    <h3 class="step-title screensteps-heading">Configure Gradebook settings.</h3>
        <div class="image screensteps-image">
      <img src="https://media.screensteps.com/image_assets/assets/009/391/769/original/1a01c263-1907-436c-a239-d39af2f501b1.png" alt="" height="150" width="852">
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_80AC752E-F88C-4E7A-8B91-EDF5D5EE0460" class="text-block-content">
    <p>To configure the external tool to send information to the Gradebook, enter a title for the gradebook item to be created.</p>
  </div>
</div>
 
  </div>
 
        <div class="step screensteps-section screensteps-depth-2" id="launch-window-information-optional">
    <h3 class="step-title screensteps-heading">Configure Launch Window Information.</h3>
        <div class="image screensteps-image">
      <a href="https://media.screensteps.com/image_assets/assets/009/391/770/original/8f2ab668-9150-4381-8ce8-5bc3dc5be54a.png" class="screensteps-image-zoom">
        <img src="https://media.screensteps.com/image_assets/assets/009/391/770/medium/8f2ab668-9150-4381-8ce8-5bc3dc5be54a.png" alt="" height="200" width="855">
      </a>
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_2C3E740E-59C6-4A7B-9D36-C258D030B979" class="text-block-content">
    <ol>
<li>Check <strong>Open in a New Window</strong> to open the tool in a new window.</li>
<li>Enter an<strong> iFrame Height </strong>in pixels to set the frame to a particular size.</li>
<li>Activate <strong>Debug Launch</strong> to displays the launch data each time the external tool is used. This feature is helpful if troubleshooting the tool configuration.</li>
</ol>
  </div>
</div>
 
  </div>
 
        <div class="step screensteps-section screensteps-depth-2" id="user-information">
    <h3 class="step-title screensteps-heading">Release user information.</h3>
        <div class="image screensteps-image">
      <a href="https://media.screensteps.com/image_assets/assets/009/391/772/original/e1f5f60e-9e98-4d51-b2e1-ff8b1e4093a1.png" class="screensteps-image-zoom">
        <img src="https://media.screensteps.com/image_assets/assets/009/391/772/medium/e1f5f60e-9e98-4d51-b2e1-ff8b1e4093a1.png" alt="" height="220" width="855">
      </a>
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_48F854AE-A591-410A-89C8-73BC06601D4A" class="text-block-content">
    <p>The external tool configuration also includes the ability to send or suppress user identity information to the external tool, such as the user's name or email address. Check </p>
<ol>
<li>
<strong>Send Names to the External Tool</strong>, </li>
<li>
<strong>Send Email Addresses to the External Tool</strong>, and/or </li>
<li>
<strong>Allow the External Tool to retrieve the course roster</strong> </li>
</ol>
<p>to release this information to the external tool.</p>
  </div>
</div>
 
  </div>
 
        <div class="step screensteps-section screensteps-depth-2" id="splash-screen-optional">
    <h3 class="step-title screensteps-heading">Splash Screen (Optional)</h3>
        <div class="image screensteps-image">
      <img src="https://media.screensteps.com/image_assets/assets/009/391/774/original/46f066c8-9cd0-4a33-97d1-2437537d6c87.png" alt="" height="356" width="853">
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_DED50735-D958-4A78-B466-94718E7E72E1" class="text-block-content">
    <p>Add information to the <strong>Splash Screen</strong> field to display custom text to users before they are redirected to the external tool.</p>
  </div>
</div>
 
      <div class="step-instructions screensteps-textblock screensteps-wrapper--info screensteps-wrapper">
  <div id="text-content_FE1F1FBB-A47B-4C62-80EA-9DF1B93560D7" class="text-block-content">
    <p><em>Note: This field is plain text only. HTML is not allowed.</em></p>
  </div>
</div>
 
  </div>
 
        <div class="step screensteps-section screensteps-depth-2" id="custom-launch-parameters-optional">
    <h3 class="step-title screensteps-heading">Custom Launch Parameters (Optional)</h3>
        <div class="image screensteps-image">
      <img src="https://media.screensteps.com/image_assets/assets/009/391/775/original/f461a6cb-797a-466a-980e-af24ae6c72ba.png" alt="" height="378" width="852">
  </div>
 
      <div class="step-instructions screensteps-textblock">
  <div id="text-content_F7557DE8-E3A4-4CD8-ADBD-0D6270B4485F" class="text-block-content">
    <p>Set custom launch parameters in the <strong>Custom Launch Parameters</strong> field.</p>
  </div>
</div>
 
  </div>
 
        <div class="step screensteps-section screensteps-depth-2" id="click-update-options-to-save-your-configuration-settings">
    <h3 class="step-title screensteps-heading">Click Update Options to save your configuration settings.</h3>
        <div class="image screensteps-image">
      <img src="https://media.screensteps.com/image_assets/assets/009/391/776/original/0774d2ee-7115-4330-97cd-d1d01ea5b1b3.png" alt="" height="59" width="257">
  </div>
 
  </div>
 
  </div>


</div>
</div></div>
</body>
</html>
